home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / bbs / outil179.zip / PHATCH.DOC < prev    next >
Text File  |  1997-04-30  |  3KB  |  87 lines
  1. PHATCH
  2.  
  3. PHATCH is an Opus 1.79 specific pre-processor for HATCH.EXE.  In other 
  4. words, you run it before running HATCH, because HATCH is not aware of 
  5. the new file database structure in Opus 1.79, and you still need to 
  6. add new file names and descriptions to your file database. 
  7.  
  8. It enters a hatched file to your Opus 1.79 file database and invokes 
  9. HATCH to generate the corresponding TIC files.  A companion program 
  10. for PTIC, PHATCH uses the same TIC.CFG file and the same requirements. 
  11.  
  12. It uses the same rules as HATCH for finding the TIC.CFG file.  
  13. Firstly, it looks for the command line switch /C, then for the 
  14. environment variable TIC, and then for TIC.CFG in the current 
  15. directory. 
  16.  
  17.  
  18. Command Line Switches:
  19. ======================
  20.  
  21.     /a   file echo area name
  22.     /c   TIC configuration file name
  23.     /d   file description (must be last arg)
  24.     /f   name of file to HATCH
  25.     /h   do NOT execute hatch.exe
  26.     /l   log file name
  27.     /ON  no wait
  28.     /Rxx release in xx days
  29.     /v   verbose gives very detailed output (for debugging)
  30.  
  31. Most of the above params are the same as for HATCH.
  32.  
  33.  
  34. Preparing TIC.CFG:
  35. ==================
  36.  
  37. Comment or delete all the FILES.BBS statements like ListFmt and 
  38. ListName from your TIC.CFG file. 
  39.  
  40.  
  41. Setting The Environment:
  42. ========================
  43.  
  44. Since Opus allows the system dat files and the user file to be located 
  45. in a directory other than the Opus home directory, support has been 
  46. added to look up these paths in the Opus prm file. 
  47.  
  48. Set up an environment variable labeled OPUS, and specify the full 
  49. pathname of the prm file as follows: 
  50.  
  51.      SET OPUS=C:\OPUS\BBS.PRM
  52.  
  53. If your environment space is cramped, you may leave off the .PRM 
  54. suffix, the program will add it.  BTW, Doug and I are making the OPUS 
  55. environment variable a standard for all the OPUS utilities. 
  56.  
  57. If the OPUS environment variable is not set, the program will look in 
  58. the current working directory for USER.DAT and SYSMSG.DAT. If either 
  59. file is not found, it will then look for BBS.PRM and look up the paths 
  60. in there. If none of the above are found, the program will fail. 
  61.  
  62.  
  63. What Happens:
  64. =============
  65.  
  66. When you invoke PHATCH, here's what happens:
  67.  
  68. 1.  PHATCH reads your TIC.CFG.
  69.  
  70. 2.  PHATCH reads your input (via the command line switches or the
  71.     interactive prompts) to post the file and prepare a command
  72.     line instruction for HATCH.
  73.  
  74. 3.  HATCH is invoked to generate the corresponding TIC files
  75.     and post the entry to the default file listing Files.Bbs.
  76.  
  77. 4.  PHATCH returns (having already read the TIC.CFG) awaiting
  78.     fresh input.  You may default the current file area or enter 
  79.     a new one.
  80.  
  81. 5.  PHATCH exits when you hit <ENTER> with no fresh input.
  82.  
  83.  
  84. John Valentyn 1:114/5@fidonet.org
  85.  
  86.  
  87.